package com.shortLinked.admin.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.shortLinked.admin.dao.entity.UserDO;
import com.shortLinked.admin.dto.req.UserLoginReqDTO;
import com.shortLinked.admin.dto.req.UserRegisterReqDTO;
import com.shortLinked.admin.dto.req.UserUpdateReqDTO;
import com.shortLinked.admin.dto.resp.UserLoginRespDTO;
import com.shortLinked.admin.dto.resp.UserRespDTO;

/**
 * 用户接口层
 */
public interface UserService extends IService<UserDO> {
    /**
     * 根据用户名查询用户信息
     *
     * @param username 用户名
     * @return 返回响应实体
     */
    UserRespDTO getUserByUsername(String username);

    /**
     * 根据用户名判断用户是否存在
     * true -> 不存在
     * false -> 存在
     *
     * @param username 用户名
     * @return 是否存在
     */
    Boolean hasUsername(String username);

    /**
     * 用户注册
     *
     * @param requestParm 用户注册参数
     */
    void registerUser(UserRegisterReqDTO requestParam);

    /**
     * 根据用户名修改用户
     */
    void updateUser(UserUpdateReqDTO requestParam);

    /**
     * 根据用户信息进行登录
     * 返回 token
     */
    UserLoginRespDTO login(UserLoginReqDTO requestParam);

    /**
     * 验证用户是否登录 -> token
     */
    Boolean checkLogin(String username, String token);

    /**
     * 用户退出登录
     */
    void logout(String username, String token);
}
